home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 38 / Amiga Format CD38 (1999-03-15)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-04].iso / -screenplay- / shareware / yarzee / yarzee10b.readme < prev    next >
Text File  |  1999-01-25  |  8KB  |  179 lines
  1. Short:    MUI Yahtzee clone.
  2. Author:   Richard Townsend <rick@albrich.demon.co.uk>
  3. Uploader: Richard Townsend <rick@albrich.demon.co.uk>
  4. Version:  0.10b
  5. Type:     game/think
  6.  
  7.                     ****** FREEWARE NOTICE ******
  8.  
  9. You may distribute this game freely provided this .readme is
  10. included and no fee is charged other than a small fee for copying.
  11.  
  12.                     ****** FREEWARE NOTICE ******
  13.  
  14. Yep another Yahtzee clone, why? well the usual reason I guess, just
  15. couldn't find one I liked. I wanted a Workbench game which looked
  16. good, was easy to play, supported multiple players.....
  17.  
  18. If you want to know more about the development of this game read the
  19. HISTORY section.
  20.  
  21. This is a beta version, I intend to refine the code and add some
  22. other features soon. If you like it, if you think it can be improved
  23. on, or would like to have some additional features, find any bugs!
  24. then send email to the address below. The latest version is available
  25. from my website (www.albrich.demon.co.uk)
  26.  
  27. INSTALLATION
  28. Un-archive and copy to your hard drive or floppy disk. The game
  29. requires that you have installed the MUI user system available from
  30. Aminet util/libs/mui38usr.lha.
  31.  
  32. GETTING STARTED
  33. Double click the Yarzee icon this brings up the config window. Enter a
  34. players name and click 'Add Player' or press 'enter' repeat for the
  35. required number of players (up to 9 players) then click 'Start Game.'
  36. If no name is entered the defaults (One,Two...) will be used.
  37.  
  38. Player names are retained between games, you do not need to enter them
  39. again as long as you don't quit the program. If at any time you return
  40. to the config window eg. by closing the game window, closing the game
  41. over window or selecting the menu option 'New game' simply click 'Add
  42. Player' until the required number of players is displayed, then click
  43. 'Start Game.'
  44.  
  45. When the game is over the game over window will be displayed offering
  46. the options 'Play again' and 'Quit'. The first will re-start the game
  47. with the same settings, the second will quit the program.
  48.  
  49. If you run Yarzee on an 8 color WB many of the dice colors may not
  50. display as intended, the White & Black and Black & White options
  51. should work ok. The minimum colors required for the other dice color
  52. options is 16.
  53.  
  54. Clicking on the 'Roll' text (top right) will toggle all holds.
  55.  
  56. NOTE
  57. In previous docs I said that if you run WB in Hires (640x256 PAL or
  58. 640x200 NTSC) reducing the font size would allow you to run Yarzee. My
  59. sincere apologies to anyone who tried this, sorry, Yarzee won't work
  60. on a Hires screen, there is not enough room to open the game window.
  61. Try running it in Hires interlace. If enough ppl ask for a Hires
  62. version I may be persuaded to produce a revised interface or add a
  63. Hires option.
  64.  
  65.  
  66. HISTORY
  67. A couple of weeks before Christmas I was visiting a friend, after a
  68. few drinks he suggested we play Yahtzee, a game I'd heard of but never
  69. seen or played. I liked it and thought I'd take a look on Aminet for
  70. an Amiga version, as I've already said, I didn't like any of the ones
  71. on Aminet so decided to write one myself. I don't have much experience
  72. of coding in C or using MUI. I had written one other program a while
  73. ago which used MUI (GSguiThor) which was never released because I
  74. accidentally deleted the code, :-( and so could not support further
  75. development.
  76.  
  77. Writing Yarzee solved two problems I got the game the way I wanted and
  78. had something to do over the Xmass break. At this time I had no
  79. intention of putting it on Aminet. When the game was working ok I
  80. thought I might as well upload it, and did so on Christmas eve. As
  81. there are several versions already there and its not a new game, I did
  82. not expect much if any response. Boy was I surprised when I started to
  83. receive email responses within a couple of days (the first on boxing
  84. day!) The Amiga community is alive and functioning well, enthusiasm
  85. for the platform is amazingly high considering the current on-going
  86. state of hardware development, and how far behind our beloved Amiga
  87. has got power wise. (I won't pay 800UKP for a PPC accelerator, I could
  88. buy a very nice PC for that!!!)
  89.  
  90. The revision history (below) shows how Yarzee has continued to develop
  91. as a direct response to the ppl who sent email asking for various
  92. additions and features. As the TODO list indicates, I will add score
  93. cards for other Yahtzee versions in the near future, and would like to
  94. add sound. At first glance audio looks to be quite involved and I'm
  95. not likely, in the foreseeable future, to be able to spend the time
  96. figuring out how to add this in a way which allows it to function with
  97. various audio cards (AHI?) and the standard Amiga sound system. So if
  98. anyone reading this would like to help out I'm open to offers.
  99.  
  100. The source has now been localized, and a French catalog is available.
  101. My thanks to the following ppl who have offered translations.
  102.  
  103. Stéphane Payet      for the French catalog.
  104. Andreas Puch        currently producing a German catalog.
  105. Lorens Johansson    for the offer of a Swedish catalog.
  106.  
  107. My thanks also to the above and all those who responded via email
  108. with suggestions bug reports and just to say they liked the game.
  109.  
  110.  
  111. REVISION HISTORY
  112. Yarzee.lha v0.01b Has a bug in the layout which causes the score card
  113.                   entries not to line up correctly with some fonts.
  114.  
  115. Yarzee02b.lha v0.02b Fixed layout bug. (Not released to Aminet.)
  116.  
  117. Yarzee03b.lha v0.03b You can now enter real names.
  118.  
  119. Yarzee04b.lha v0.04b Players can now exit their turn without rolling
  120.                      the dice 3 times.
  121.  
  122. Yarzee05b.lha v0.05b Speeded up dice rolling added About MUI menu
  123.                      option. General code tidy up.
  124.  
  125. Yarzee06b.lha v0.06b Added different color dice and current roll
  126.                      number. Removed the restriction of only being
  127.                      able to enter a-z | A-Z in name gadget. Fixed (I
  128.                      hope) repeating dice sequences. 
  129.  
  130. Yarzee07b.lha v0.07b Major code update. Added something??? (Don't want
  131.                      to spoil the surprise.) Fixed the random number
  132.                      generator. Localized (catalog description file
  133.                      included.)(Not released to Aminet.)
  134.  
  135. Yarzee08b.lha v0.08b Wow a couple of bugs crept into the last
  136.                      revision, fixed now. ;-) 
  137.  
  138. Yarzee09b.lha v0.09b The previous revision had a bug in the
  139.                      localisation, now fixed (I hope.)
  140.  
  141. Yarzee10b.lha v0.10b Added toggle all holds feature. Plus minor code
  142.                      revision.
  143.  
  144. TODO
  145. 1/ Design game icon.
  146. 2/ Add alternative score cards for some of the Yahtzee variations.
  147. 3/ Add save game config menu item & high score table.
  148.    (This will include saving player names.)
  149. 4/ Add sound for scoring a Yarzee and for game over.
  150.    (If enough ppl ask for it.)
  151.  
  152.  
  153. ABOUT THE AUTHOR
  154. I'm not really a programmer, I call myself a multimedia author, which
  155. covers a variety of sins.
  156.  
  157. What I do; HTML (website authoring), cgi scripting (Perl), 3D
  158. animation & GFX, multimedia authoring (Director), Video production
  159. (filming, editing, creative direction.) For further information I can
  160. be contacted at the address below.
  161.  
  162.  
  163.                         ****** WARNING ******
  164.  
  165. This is beta software it may destroy your computer, eat your grandma
  166. etc. ;-) I can not be held responsible for any damage caused.
  167.  
  168.                         ****** WARNING ******
  169.  
  170. Author:     Rick Townsend
  171. Company:    Albrich interactive
  172. Address:    11 Cobbett Road
  173.             Honicknowle
  174.             Plymouth
  175.             PL5 3LD
  176. Tel:        +44 (0)1752 213056
  177. Email:      rick@albrich.demon.co.uk
  178. URL:        http://www.albrich.demon.co.uk/
  179.